v5.2.1

Small bug fix release.

Bug Fixes

• Fix GuildManager#setSafetyAlertsChannel by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2765
• Correctly handle disabled intent in setEnabledIntents by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2767
• Ensure label cannot be null in Button by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2771
• Handle user in EntityBuilder#createApplicationEmoji as optional by @​Xirado in https://github.com/discord-jda/JDA/pull/2769

Full Changelog: discord-jda/JDA@v5.2.0...v5.2.1

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.2.1")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.2.1</version> 
</dependency>

v5.2.0: | Application emoji and premium buttons

Overview

This release adds some new features for applications. We've also started working on more compliance tests to make contributing and reviewing changes easier.

Premium Buttons (#​2752)

The interaction response replyWithPremiumRequired is being phased out in favor of custom messages with a new button style Button.premium(sku) to upsell specific premium features instead.

You can change your code to a simple reply(content) with this button as a component.

event.reply("This feature is only available for premium users.")
  .addActionRow(Button.primary(SkuSnowflake.fromId(PREMIUM_FEATURE_SKU)))
  .setEphemeral(true)
  .queue();

For more info, see the official Discord Changelog.

Application Emoji (#​2726)

Your bot can now manage emoji with JDA by using JDA#createApplicationEmoji. These emojis can then be used like any other emoji with Emoji.fromCustom(name, id, animated).

New Features

• Added Safety Alerts Channel by @​RealYusufIsmail in https://github.com/discord-jda/JDA/pull/2725
• Add ScheduledEvent::getJumpUrl by @​raul1ro in https://github.com/discord-jda/JDA/pull/2736
• Add premium buttons by @​freya022 in https://github.com/discord-jda/JDA/pull/2752
• Add support for Application Emoji by @​yoyosource in https://github.com/discord-jda/JDA/pull/2726

Bug Fixes

• Fix handling of passing null to setMessageReference by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2749

Changes

• Deprecated GatewayIntent#GUILD_EMOJIS_AND_STICKERS in favor of GUILD_EXPRESSIONS by @​freya022 in https://github.com/discord-jda/JDA/pull/2755
• Remove deprecated permission constants
• Remove deprecated and stage instance privacy level

Full Changelog: discord-jda/JDA@v5.1.2...v5.2.0

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.2.0")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.2.0</version> 
</dependency>

v5.1.2: | Message Forwarding and Voice Messages

Overview

This release adds support for new message features.

Forwarding messages (#​2744)

You can now handle forwarded messages using the new message snapshots.

@​Override
public void onMessageReceived(MessageReceivedEvent event) {
    MessageReference messageReference = event.getMessage().getMessageReference();
    // Forwarded messages have a reference of type FORWARD
    if (messageReference != null && messageReference.getType() == MessageReference.MessageReferenceType.FORWARD) {
        // The content of the forwarded message is provided as a snapshot
        MessageSnapshot snapshot = event.getMessage().getMessageSnapshots().getFirst();
        System.out.println("Received forwarded message with content: " + snapshot.getContentRaw());
    }
}

A bot can also forward a message using Message#fowardTo. Note that a forwarded message cannot contain any additional content.

Voice messages (#​2738)

You can now send voice messages with JDA, by utilizing the new FileUpload#asVoiceMessage method on your audio attachments.

channel.sendFiles(
  FileUpload.fromData(audioFile)
    .asVoiceMessage(MediaType.parse("audio/ogg"), waveform, 10.5) // 10.5 seconds audio/ogg message
).queue();

To create a voice message, you must first determine the audio media type of your voice message and sample a waveform up to 256 bytes. Voice messages require a valid audio/* media type like audio/ogg.

The waveform is used to render the voice message shape in the preview. It must not be an accurate sampling of the actual audio.

New Features

• Add support for message forwarding by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2744
• Support sending voice messages by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2738

Bug Fixes

• Fix ScheduledEventManagerImpl::setStatus by @​raul1ro in https://github.com/discord-jda/JDA/pull/2743

Full Changelog: discord-jda/JDA@v5.1.1...v5.1.2

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.1.2")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.1.2</version> 
</dependency>

v5.1.1: | Small bugfix release

Overview

Small release to fix a few bugs. This fixes an issue that caused voice receive to no longer work as intended in 5.1.0.

Bug Fixes

• Remove extension from received audio packets by @​davidffa in https://github.com/discord-jda/JDA/pull/2721
• Remove @CheckReturnValue from Once.Builder.subscribe by @​freya022 in https://github.com/discord-jda/JDA/pull/2730
• Fix parsing error for AutoModResponse by @​StasiumDev in https://github.com/discord-jda/JDA/pull/2728

Full Changelog: discord-jda/JDA@v5.1.0...v5.1.1

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.1.1")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.1.1</version> 
</dependency>

v5.1.0: | Voice Gateway v8

Overview

This release updates the implementation of the voice gateway to API version 8 (previously 4). Previous versions will be incompatible coming November 18, 2024. This includes adding a new dependency on tink, to support the new encryption modes.

Additionally, the MessageEmbedEvent has been removed. Discord sends standard update events for embed loading now, this event can no longer be supported.

New Features

• Add new message and embed types by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2716

Changes

• Upgrade to voice gateway v8 by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2717
• Remove MessageEmbedEvent by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2720

Bug Fixes

• Handle guild stickers array as optional in EntityBuilder#createGuild by @​Xirado in https://github.com/discord-jda/JDA/pull/2714

Full Changelog: discord-jda/JDA@v5.0.2...v5.1.0

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.1.0")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.1.0</version> 
</dependency>

v5.0.2: | Single time event listener

Overview

This release includes some bug fixes as well as a new event listener feature to add a one-time-use event listener.

Once Event Listener (#​2683)

A common problem that developers run into, is "waiting" for a specific event in the context of some command. For instance, waiting for a user to add a reaction or reply with a message in response to some prompt.

This can now be achieved using the new listenOnce event listener:

// listen for a message event
jda.listenOnce(MessageReceivedEvent.class)
    // filter for specific event
    .filter(event -> event.getChannel().equals(channel))
    .filter(event -> event.getAuthor().equals(user))
    // handle timeout
    .timeout(timeout, () -> hook.editOriginal("Timeout!").queue())
    // subscribe to first event that matches filters
    .subscribe(event -> {
        hook.editOriginal("You sent: " + event.getMessage().getContentRaw()).queue();
    });

New Features

• Add TeamMember.RoleType by @​freya022 in https://github.com/discord-jda/JDA/pull/2703
• Add abstract createCopy method in SelectMenu by @​Kaktushose in https://github.com/discord-jda/JDA/pull/2684
• Add JDA#listenOnce by @​freya022 in https://github.com/discord-jda/JDA/pull/2683
• Add support for profile automod by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2580

Changes

• Expand list of retried http error codes by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2710
• Update to Jackson 2.17.2 by @​freya022 in https://github.com/discord-jda/JDA/pull/2695

Bug Fixes

• Fix deserialization of interaction components by @​WitchBoo in https://github.com/discord-jda/JDA/pull/2711

Full Changelog: discord-jda/JDA@v5.0.1...v5.0.2

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.2")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.2</version> 
</dependency>

v5.0.1: | Hotfix shard manager thread handling

Overview

Small hotfix release, fixes problem with default thread config for DefaultShardManager. This caused requests to fail if a shard is stopped or restarted.

Bug Fixes

• Fix automatic shutdown for elastic pool by @​MinnDevelopment in https://github.com/discord-jda/JDA/pull/2704

Full Changelog: discord-jda/JDA@v5.0.0...v5.0.1

Installation

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.1")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.1</version> 
</dependency>

v5.0.0: | End of beta phase

The Long Awaited Stabilization

After almost 3 years of refactoring and polishing, the stabilization of JDA 5.0.0 is here. If you have been following along, not much has changed since the latest beta release.

If you have somehow avoided updating to a beta release since 2021, here is a list of the most noteworthy additions, changes, and bug fixes since 4.4.0.

You can also use our Migration Guide to help you update to the latest version of JDA 5. This guide also includes the most important changes you need to consider.

Interactions / Application Features

Discord has further improved the capabilities of applications with new types of interactions. This major release of JDA adds support for these features, coming with some restructuring to properly accomodate the new types.

We've renamed interaction events to a more consistent naming scheme:

• SlashCommandEvent becomes SlashCommandInteractionEvent
• ButtonClickEvent becomes ButtonInteractionEvent

Similarly, we've renamed component types slightly:

• SelectionMenu is now StringSelectMenu, while adding a new EntitySelectMenu
• What was previously called Component has now been renamed to ActionComponent and ItemComponent, allowing us to introduce Component as an abstraction over both Button and ActionRow (which is now a LayoutComponent). The new Component interface is now an abstraction over both ItemComponent and LayoutComponent.

To learn more about interactions in JDA 5, take a look at our Interactions Wiki Guide.

Channel Type Rework

We've refactored the channel types and usages in JDA to be more maintainable. Each type of channel now directly maps to a specific channel interface, unlike before where VoiceChannel was used for both stage and voice type channels.
Instead there are now concrete interfaces for each type, such as NewsChannel, StageChannel, ForumChannel, etc.

The channel type hierarchy has been further refined, by introducing higher level abstractions to represent the features of multiple channel types:

• Channel
• GuildChannel
• MessageChannel and GuildMessageChannel
• AudioChannel

As well as more specific features or attributes of channels:

• IPermissionContainer
• IPositionableChannel
• IThreadContainer
• IWebhookContainer
• etc.

To properly maintain these many different channel types and make them easy to use, we've also introduced new union types to encompass multiple channels into a simple common union type. This replaces the old getTextChannel()/getVoiceChannel() getters on events with getChannel().asTextChannel(). However, you can also use the standard features of the unions directly. For instance, a MessageChannelUnion allows to send messages and these specialization methods:

MessageChannelUnion channel = event.getChannel();
channel.sendMessage("hello").queue();
if (channel.getType() == TEXT) {
  channel.asTextChannel().getManager().setTopic("test topic").queue();
}

Cache access has also seen some improvement, by introducing a new getChannelById(Class, long) method, allowing to just get a MessageChannel without worrying about the concrete type.

GuildMessageChannel channel = guild.getChannelById(GuildMessageChannel.class, 125227483518861312L);
channel.sendMessage("Hello general chat!").queue();

Learn more about the channel rework in Channel Rework.

Message Features

We've refactored our message sending interfaces to be more consistent, by abstracting MessageAction, MessageBuilder, and ReplyAction into shared interfaces MessageCreateRequest and MessageEditRequest. This makes all message sending code consistent. We recommend to simply chain your builder-like code directly on send messages:

channel.sendMessage("Hello World")
  .setComponents(ActionRow.of(button1, button2))
  .setEmbeds(embed1, embed2)
  .setFiles(files)
  .queue();

However, if you need to use builders, we've introduced MessageEditBuilder and MessageCreateBuilder to replace the old MessageBuilder utility. You can also now use SplitUtil to easily divide message content into multiple messages.

To support file descriptions and reduce the number of sendFile overloads, we've also introduced a new FileUpload type that unifies all attachments into a single type.

FileUpload file = FileUpload.fromData(new File("myFile.png"), "image.png")
  .setDescription("this is my alt text for screenreaders, allowing to make accessible images in your messages!");
channel.sendFiles(file).queue();

Learn more about the changes to message sending in Message Send/Edit Rework.

Emojis and Stickers

In JDA 5, we have decided to unify all emoji types into a consistent type structure:

• Emoji, a top-level interface representing all emoji as well as a type discriminator with Emoji#getType
• UnicodeEmoji, standard unicode emoji such as 🤔
• CustomEmoji, custom emoji found in messages, like <:minn:245267426227388416>
• RichCustomEmoji, emoji with more information such as owner, accessible through the guild settings.
• EmojiUnion, adding type casting for things like MessageReaction#getEmoji

These new emoji types replace the duplication of ReactionEmote and Activity.Emoji.

Stickers have also been refactored in a similar way, making a clear distinction between stickers found in messages and guild settings:

• Sticker, a top-level abstraction of all sticker types
• StickerItem, stickers found in messages
• RichSticker, stickers with more information that is usually omitted for messages (sticker items)
• StandardSticker, rich stickers provided by nitro instead of guilds
• GuildSticker, rich stickers provided in guilds
• StickerUnion, adding type casting

Learn more about the changes to emojis and stickers in Sticker and Emoji Rework.

Installation

All future JDA releases will be distributed through maven central. You no longer need to use jcenter() in your dependency manager.

Gradle

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.0")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0</version> 
</dependency>

Changelog (5.0.0-beta.24 -> 5.0.0)

The changes since the latest beta release to this release.

• Allow UserSnowflake subtypes in bulk ban methods by @​freya022 (#​2689)
• Update MessageType enum by @​MinnDevelopment (#​2691)
• Improve Unknown Interaction error responses by @​freya022 (#​2687)
• Update ErrorResponse enum by @​MinnDevelopment (#​2693)
• Add missing permissions by @​MinnDevelopment (#​2690)
• Update and remove deprecated symbols by @​MinnDevelopment (#​2686)

Changelog (4.4.0 -> 5.0.0)

Note that this changelog is a linear history of changes. This means some earlier changes have already been superseded or refined in more recent changes. This changelog is slightly compressed to remove unimportant changes, you can see the full list of commits here.

Thank you all for contributing!

New Features

Breaking Changes

Other Changes

Bug Fixes

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

• If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.